dispatch_cr

Public Function dispatch_cr(ByVal cr_id As String, _

    ByVal queue_name As String, _

                            ByVal disp_date As String, _

    ByVal user_name As String, _

                            ByVal gen_time_bombs As Boolean) As Integer

Description

This API causes the specified change request to be dispatched to the specified queue. The change request must not be currently dispatched to a queue. The API allows for the setting of the dispatch date, and the user who dispatched the change request. The APIs can also generate a time bomb (for business rule notification).

Parameters

Parameter Name                Required?             Description                                                                                                          

cr_id                                       Yes                         The change request Id to be dispatched

queue_name                         Yes                         The queue to dispatch to

disp_date                              No                           When was the change request dispatched. If this parameter is left blank, the

CR is dispatched at the current time

user_name                             No                           The user who dispatched the change request. If left blank, the current user                                                                            performs the dispatch

gen_time_bombs                 Yes                         Should a time_bomb be generated (for notifications/business rules)

Returns     

Value                                     Meaning                                                                                                                                               

0                                              No errors

-1                                             Cannot find the specified change request

-2                                             The change request is already dispatched

-3                                             The change request is closed and may not be dispatched

-4                                             The specified user cannot be found

-5                                             The specified new queue name cannot be found

-6                                             Cannot find gbst_elm rank 900 for string DISPATCH

-7                                             Not allowed to dispatch a CR to the specified queue

Examples  

·         Dispatch change request number '10' to queue 'Hardware'. The dispatch is performed by the current user and is dispatched at the current time. Generate a time bomb.

Visual Basic:

Dim ret_int As Integer

ret_int = fccq.dispatch_cr("10", "Hardware", "", "", True)

JavaScript:

var ret_int = fccq.dispatch_cr("10", "Hardware", "", "", true);

·         Dispatch change request number '2' at 10PM on November 23^rd of 1997 to queue 'Software'. Dispatch should be logged as performed by nancy. Don't generate a time bomb.

Visual Basic:

Dim ret_int As Integer

ret_int = fccq.dispatch_cr("2", "Software", "11/23/97 22:00:00", _

                           "nancy", False)

JavaScript:

var ret_int = fccq.dispatch_cr("2", "Software", "11/23/97 22:00:00", _

                           "nancy", false);